<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - Slab</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu142.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu144.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDRSLAB" ></A>Slab</H3>
		<A NAME="IDX712"></A><A NAME="IDX713"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATIAE">Import and Export</A>
<A NAME="IDX714"></A>
<P><STRONG>Function</STRONG>
<P>
Creates a "slab" of data.
<P><STRONG>Syntax</STRONG>
<PRE><STRONG>
output</STRONG> = Slab(<STRONG>input, dimension, position, thickness</STRONG>);
</PRE>
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>input</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">none
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">object to be "slabbed"
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>dimension</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or string
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">spatial orientation of the slab
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>position</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or integer list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">all
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">starting position(s)
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>thickness</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">0 or 1
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">thickness of slab (in number of
elements)
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>output</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field or field series
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">slabbed data
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module creates a multidimensional object consisting of a selected
subset of input data.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>data</STRONG></TT>
</B></TD><TD><P>specifies the data field to be slabbed.
This field must have regular connections.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>dimension</STRONG></TT>
</B></TD><TD><P>specifies the dimension in which the slab should be oriented
relative to the input object (the output slab will have the
same orientation).
The <I>n</I> dimensions of the object can be specified by number
(from 0 to <I>n</I> &#45; 1).
The first three dimensions can also be specified as <I>x</I>,
<I>y</I>, and <I>z</I>, respectively.
<P>
The default for this parameter is dimension 0 (zero).
<P><B>Notes: </B><OL>
<P><LI>The <TT><STRONG>dimension</STRONG></TT> number refers to the ordering of
positions in the "connections" component.
Thus, <I>x</I> corresponds to 0 only if the positions have been
specified as <I>x</I> varies slowest.
<P><LI>Slab can also be used on deformed grids, in which case the
connections do not align with any particular axis.
<P><LI>Transposing the positions (i.e., with Transpose) does <I>not</I>
change the order in the "connections" component.
</OL>
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>position</STRONG></TT>
</B></TD><TD><P>specifies the position from which the slab is generated.
<P>
If the specified value is a single integer, the module creates a single
field, with the slab oriented in the specified dimension and
containing the number of volume elements specified by
<TT><STRONG>thickness</STRONG></TT> (see below).
<P>
If <TT><STRONG>position</STRONG></TT> is a list of integers, the module
creates a series of specified slabs, and the default value
of <TT><STRONG>thickness</STRONG></TT> is 1 (one).
<P>
If this parameter is not specified, the output is a series of slabs
(<TT><STRONG>thickness</STRONG></TT> = 1) that begin at every
grid position along <TT><STRONG>dimension</STRONG></TT>.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>thickness</STRONG></TT>
</B></TD><TD><P>specifies the thickness of the slab (in volume elements).
A specified value of 0 (the default when <TT><STRONG>position</STRONG></TT>
is a single number) will produce a 2-dimensional slice in a
3-dimensional object.
</TD></TR></TABLE>
<P><B>Notes: </B><OL>
<P><LI>This module performs no interpolation, and only data with regular
connections can be slabbed.
<P><LI>If the input object is already colored, the colors are passed
through unaltered.
<P><LI>If the input object is a volume and the requested
slab is much thinner than
the input object, the colors for volume rendering
may be dim.
<P><LI>If the data are connection dependent, a request for a slab of
<TT><STRONG>thickness</STRONG></TT> = 0 is ill-defined and the
module returns an error.
</OL>
<P><STRONG>Components</STRONG>
<P>
All input components are propagated to the output.
<P><STRONG>Example Visual Programs</STRONG>
<PRE>
Imide&#95;potential.net
RubberTube.net
Streamline.net
SIMPLE/Slab.net
</PRE>
<P><STRONG>See Also</STRONG>
<P>
&nbsp;<A HREF="refgu092.htm#HDRMAPTOPL">MapToPlane</A>,
&nbsp;<A HREF="refgu131.htm#HDRSELECT">Select</A>,
&nbsp;<A HREF="refgu144.htm#HDRSLICE">Slice</A>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
